home *** CD-ROM | disk | FTP | other *** search
/ Language/OS - Multiplatform Resource Library / LANGUAGE OS.iso / gnu / uucp-104.lha / uucp-1.04 / README < prev    next >
Text File  |  1993-02-13  |  9KB  |  208 lines
  1. This is the README file for version 1.04 of the Taylor UUCP package.
  2.  
  3. It was written by Ian Lance Taylor.  I can be reached at ian@airs.com,
  4. or, equivalently, uunet!cygint!airs!ian, or c/o Cygnus Support, 4th
  5. Floor, Building 200, 1 Kendall Square, Cambridge MA, 02139, USA.
  6.  
  7. There is a mailing list for discussion of the package.  To join (or
  8. get off) the list, send mail to taylor-uucp-request@gnu.ai.mit.edu.
  9. Mail to this address is answered by a person, not a program.  When
  10. joining the list, make sure you include the address at which you want
  11. to receive mail in the body of your message.  To send a message to the
  12. list, send it to taylor-uucp@gnu.ai.mit.edu.
  13.  
  14. This package is covered by the Gnu Public License.  See the file
  15. COPYING for details.  If you would like to do something with this
  16. package that you feel is reasonable but you feel is prohibited by the
  17. license, contact me to see if we can work it out.
  18.  
  19. WHAT IT IS
  20.  
  21. This is the complete source code for a Unix UUCP package.  It provides
  22. everything you need to make a UUCP connection.  It includes versions
  23. of uucico, uusched, uuxqt, uux, uucp, uustat, uulog, uuname, uuto,
  24. uupick, and cu, as well as uuchk (a program to check configuration
  25. files), uuconv (a program to convert from one type of configuration
  26. file to another) and tstuu (a test harness for the package).
  27.  
  28. The Free Software Foundation plans to make this their standard UUCP
  29. package.
  30.  
  31. The package currently supports the 'f', 'g' (in all window and packet
  32. sizes), 'G', 't' and 'e' protocols, as well a Zmodem protocol and two
  33. new bidirectional protocols.  If you have a Berkeley sockets library,
  34. it can make TCP connections.  If you have TLI libraries, it can make
  35. TLI connections.  It supports a new configuration file mechanism which
  36. I like (but other people dislike).
  37.  
  38. The package has a few advantages over regular UUCP:
  39.  
  40.     You get the source code.
  41.  
  42.     It uses significantly less CPU time than many UUCP packages.
  43.  
  44.     You can specify a chat script to run when a system calls in,
  45.     allowing adjustment of modem parameters on a per system basis.
  46.  
  47.     You can specify failure strings for chat scripts, allowing the
  48.     chat script to fail immediately if the modem returns ``BUSY''.
  49.  
  50.     If you are talking to another instance of the package, you can use
  51.     the new bidirectional protocol for rapid data transfer in both
  52.     directions at once.  You can also restrict file transfers by size
  53.     based on the time of day and who placed the call.
  54.  
  55. On the other hand:
  56.  
  57.     It only runs on Unix.  The code is carefully divided into system
  58.     dependent and system independent portions, so it should be
  59.     possible to port it to other systems.  It would not be trivial.
  60.  
  61.     You don't get uuclean, uusend, uuq, uusnap, uumonitor, uutry,
  62.     uupoll, etc.  If you have current copies of these programs, you
  63.     may be able to use them.  Shell scripts versions of uuclean and
  64.     uutry are provided, with most, if not all, of the functionality of
  65.     the usual programs.  I believe the supplied uustat program allows
  66.     you to do everything that uuq, uusnap and uumonitor do.  uupoll
  67.     could be written as a shell script.
  68.  
  69.     The package does not read modemcap or acucap files, although you
  70.     can use V2 configuration files with a BNU Dialers file or a dialer
  71.     file written in my new configuration file format.
  72.  
  73.     The package cannot use SCO dialer programs directly, although it
  74.     can with a simple shell script interface.
  75.  
  76. If you start using this package, I suggest that you join the mailing
  77. list (see above) to keep up to date on patches and new versions.  I am
  78. also open to suggestions for improvements and modifications.
  79.  
  80. CHANGES SINCE 1.03
  81.  
  82. For a complete list, see ChangeLog.
  83.  
  84. IMPORTANT: the default when talking to another version of 1.04 is to
  85. use the new bidirectional 'i' protocol.  If you are using a
  86. half-duplex modem, such as a Telebit T2500, you will want to either
  87. mark the port as half-duplex with the ``half-duplex'' command, or
  88. force use of the 'g' protocol by using the ``protocol'' command in the
  89. sys or port file or by adding ``,g'' after the port name in the
  90. Systems or L.sys or Devices file.
  91.  
  92.     As usual, many bugs were fixed.
  93.  
  94.     Bidirectional transfers are supported with the new 'i' protocol;
  95.     it requires an eight-bit clear datapath.
  96.  
  97.     New programs: uusched, cu, uuto and uupick.
  98.  
  99.     The 'G' protocol and a new Zmodem protocol were added.
  100.  
  101.     A number of uustat options were added to support uuclean, and a
  102.     sample uuclean shell script was added to the contrib directory.
  103.     The uustat output formats were changed slightly.
  104.  
  105.     A protocol extension eliminates transfer of the command file for
  106.     simple commands, such as rmail or rnews, when talking to another
  107.     version of 1.04.
  108.  
  109.     Some TLI support was added.
  110.  
  111.     UUCP forwarding was added, along with the ``forward-to'',
  112.     ``forward-from'' and ``forward'' commands.
  113.  
  114.     If a file transfer fails in the middle, the retry will now start
  115.     from where it left off.  The implementation is compatible with
  116.     SVR4.
  117.  
  118.     The work queue is checked every 10 minutes during a conversation;
  119.     if there is new work and a bidirectional protocol is not in use,
  120.     the receiving uucico requests the sender to transfer control.
  121.  
  122.     The amount of free disk space is checked periodically as a file is
  123.     received, and if it drops too low the call is aborted.
  124.  
  125.     The UUCP configuration file reading routines were moved into a
  126.     standalone library, uuconf.  All known bugs in V2 and HDB
  127.     configuration file reading were fixed.
  128.  
  129.     The ``half-duplex'' command was added for the port and dialer
  130.     files.
  131.  
  132.     The ``max-retries'', ``success-wait'', ``send-request'' and
  133.     ``receive-request'' commands were added for the sys file.  The
  134.     ``call-request'' and ``called-request'' commands were eliminated
  135.     (they did not work correctly anyhow).
  136.  
  137.     \d in chat scripts now calls sleep (2) rather than sleep (1), so
  138.     it will sleep longer (on some systems sleep(1) may delay much less
  139.     than one second).
  140.  
  141.     SPOOLDIR_SVR4 was added for SVR4 style spool directories.
  142.  
  143.     Defaults are now permitted in the port and dialer files.
  144.  
  145.     The ALIAS field is supported in the HDB Permissions file.
  146.  
  147. DOCUMENTATION
  148.  
  149. The documentation is in the file uucp.texi, which is a Texinfo file.
  150. Texinfo is a format used by the Free Software Foundation.  You can
  151. print the documentation using TeX in combination with the file
  152. texinfo.tex.  DVI, PostScript and info versions of the documentation
  153. are available in a separate package, uucp-doc-1.04.tar.Z.
  154.  
  155. See the TODO file for things which should be done.  Please feel free
  156. to do them, although you may want to check with me first.  Send me
  157. suggestions for new things to do.
  158.  
  159. The compilation instructions are in uucp.texi.  Here is a summary.
  160.  
  161.     Edit Makefile.in to set installation directories.
  162.  
  163.     Type ``sh configure''.  You can pass a number of arguments in the
  164.     environment (using bash or sh, enter something like ``CC=gcc
  165.     configure''; using csh, enter something like ``setenv CC gcc; sh
  166.     configure''):
  167.         CC: C compiler to use; default is gcc if it exists, else cc
  168.         CFLAGS: Flags to pass to $CC when compiling; default -g
  169.         LDFLAGS: Flags to pass to $CC when only linking; default none
  170.         LIBS: Library arguments to pass to $CC; default none
  171.         INSTALL: Install program; default install -c or cp
  172.         INSTALLDATA: Install data; default install -c -m 0644 or cp
  173.     The configure script will compile a number of test programs to see
  174.     what is available on your system, so if your system is at all
  175.     unusual you will need to pass in $CC and $LIBS correctly.
  176.  
  177.     The configure script will create conf.h from conf.h.in and
  178.     Makefile from Makefile.in.  It will also create config.status,
  179.     which is a shell script which actually creates the files.  Please
  180.     report any configuration problems, so that they can be fixed in
  181.     later versions.
  182.  
  183.     Igor V. Semenyuk provided this (lightly edited) note about ISC
  184.     Unix 3.0.  The configure script will default to passing -posix to
  185.     gcc.  However, using -posix changes the environment to POSIX, and
  186.     on ISC 3.0, at least, the default for POSIX_NO_TRUNC is 1.  This
  187.     means nothing for uucp, but can lead to a problem when uuxqt
  188.     executes rmail.  IDA sendmail has dbm configuration files named
  189.     mailertable.{dir,pag}.  Notice these names are 15 characters long.
  190.     When uuxqt compiled with -posix executes rmail, which in turn
  191.     executes sendmail, the later is run under POSIX environment too!
  192.     This leads to sendmail bombing out with 'error opening 'M'
  193.     database: name too long' (mailertable.dir).  It's rather obscure
  194.     behaviour, and it took me a day to find out the cause.  I don't
  195.     use -posix, instead I run gcc with -D_POSIX_SOURCE, and add
  196.     -lcposix to LIBS.
  197.  
  198.     Examine conf.h and Makefile to make sure they're right.
  199.  
  200.     Edit policy.h for your local system.    
  201.  
  202.     Type ``make''.
  203.  
  204.     Use ``uuchk'' to check configuration files.  You can use
  205.     ``uuconv'' to convert between configuration file formats.
  206.  
  207.     Type ``make install'' to install.
  208.